home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3n / t_rcvuderr.z / t_rcvuderr
Encoding:
Text File  |  2002-10-03  |  7.3 KB  |  133 lines
  1.  
  2.  
  3.  
  4. tttt____rrrrccccvvvvuuuuddddeeeerrrrrrrr((((3333NNNN))))                                                  tttt____rrrrccccvvvvuuuuddddeeeerrrrrrrr((((3333NNNN))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _tttt______rrrr_cccc_vvvv_uuuu_dddd_eeee_rrrr_rrrr - receive a unit data error indication
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_ffff_dddd_eeee_ffff ______XXXX_OOOO_PPPP_EEEE_NNNN______SSSS_OOOO_UUUU_RRRR_CCCC_EEEE
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_xxxx_tttt_iiii_...._hhhh_>>>>
  14.      _####_eeee_llll_ssss_eeee
  15.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_tttt_iiii_uuuu_ssss_eeee_rrrr_...._hhhh_>>>>
  16.      _####_eeee_nnnn_dddd_iiii_ffff
  17.  
  18.      _iiii_nnnn_tttt _tttt______rrrr_cccc_vvvv_uuuu_dddd_eeee_rrrr_rrrr _((((_iiii_nnnn_tttt _ffff_dddd_,,,, _ssss_tttt_rrrr_uuuu_cccc_tttt _tttt______uuuu_dddd_eeee_rrrr_rrrr _****_uuuu_dddd_eeee_rrrr_rrrr_))))_;;;;
  19.  
  20. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  21.      This function is used in connectionless mode to receive information
  22.      concerning an error on a previously sent data unit, and should be issued
  23.      only after a unit data error indication.  It informs the transport user
  24.      that a data unit with a specific destination address and protocol options
  25.      produced an error.  _ffff_dddd identifies the local transport endpoint through
  26.      which the error report will be received, and _uuuu_dddd_eeee_rrrr_rrrr points to a _tttt______uuuu_dddd_eeee_rrrr_rrrr
  27.      structure containing the following members:
  28.  
  29.           _ssss_tttt_rrrr_uuuu_cccc_tttt _nnnn_eeee_tttt_bbbb_uuuu_ffff _aaaa_dddd_dddd_rrrr_;;;;
  30.           _ssss_tttt_rrrr_uuuu_cccc_tttt _nnnn_eeee_tttt_bbbb_uuuu_ffff _oooo_pppp_tttt_;;;;
  31.           _llll_oooo_nnnn_gggg _eeee_rrrr_rrrr_oooo_rrrr_;;;;
  32.  
  33.      _nnnn_eeee_tttt_bbbb_uuuu_ffff is described in _iiii_nnnn_tttt_rrrr_oooo(3N).  The _mmmm_aaaa_xxxx_llll_eeee_nnnn [see _nnnn_eeee_tttt_bbbb_uuuu_ffff in _iiii_nnnn_tttt_rrrr_oooo(3N)]
  34.      field of _aaaa_dddd_dddd_rrrr and _oooo_pppp_tttt must be set before issuing this function to
  35.      indicate the maximum size of the buffer for each.
  36.  
  37.      On return from this call, the _aaaa_dddd_dddd_rrrr structure specifies the destination
  38.      protocol address of the erroneous data unit, the _oooo_pppp_tttt structure identifies
  39.      protocol-specific options that were associated with the data unit, and
  40.      _eeee_rrrr_rrrr_oooo_rrrr specifies a protocol-dependent error code.
  41.  
  42.      If the user does not care to identify the data unit that produced an
  43.      error, _uuuu_dddd_eeee_rrrr_rrrr may be set to _NNNN_UUUU_LLLL_LLLL and _tttt______rrrr_cccc_vvvv_uuuu_dddd_eeee_rrrr_rrrr will simply clear the
  44.      error indication without reporting any information to the user.
  45.  
  46.      This function resides within both the X/Open compliant _llll_iiii_bbbb_xxxx_nnnn_eeee_tttt and the
  47.      SVR4 compliant _llll_iiii_bbbb_nnnn_ssss_llll Network Services libraries.  Network Services
  48.      applications which require X/Open compliance must link-load with _----_llll_xxxx_nnnn_eeee_tttt.
  49.      Network Services applications which require SVR4 compliance must link-
  50.      load with _----_llll_nnnn_ssss_llll.
  51.  
  52.      On failure, _tttt______eeee_rrrr_rrrr_nnnn_oooo may be set to one of the following:
  53.  
  54.      _TTTT_BBBB_AAAA_DDDD_FFFF             The specified file descriptor does not refer to a
  55.                        transport endpoint.
  56.  
  57.      _TTTT_NNNN_OOOO_UUUU_DDDD_EEEE_RRRR_RRRR          No unit data error indication currently exists on the
  58.                        specified transport endpoint.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. tttt____rrrrccccvvvvuuuuddddeeeerrrrrrrr((((3333NNNN))))                                                  tttt____rrrrccccvvvvuuuuddddeeeerrrrrrrr((((3333NNNN))))
  71.  
  72.  
  73.  
  74.      _TTTT_BBBB_UUUU_FFFF_OOOO_VVVV_FFFF_LLLL_WWWW         There are two different conditions in which _TTTT_BBBB_UUUU_FFFF_OOOO_VVVV_FFFF_LLLL_WWWW
  75.                        will be returned.  If ______XXXX_OOOO_PPPP_EEEE_NNNN______SSSS_OOOO_UUUU_RRRR_CCCC_EEEE is defined _aaaa_nnnn_dddd the
  76.                        number of bytes allocated for incoming data is _gggg_rrrr_eeee_aaaa_tttt_eeee_rrrr
  77.                        _tttt_hhhh_aaaa_nnnn _zzzz_eeee_rrrr_oooo _aaaa_nnnn_dddd is not sufficient to store the data.  If
  78.                        ______XXXX_OOOO_PPPP_EEEE_NNNN______SSSS_OOOO_UUUU_RRRR_CCCC_EEEE is _nnnn_oooo_tttt defined and the number of bytes
  79.                        allocated for incoming data is not sufficient to store
  80.                        the data.  The unit data error information to be
  81.                        returned in _uuuu_dddd_eeee_rrrr_rrrr will be discarded.
  82.  
  83.      _TTTT_NNNN_OOOO_TTTT_SSSS_UUUU_PPPP_PPPP_OOOO_RRRR_TTTT       This function is not supported by the underlying
  84.                        transport provider.
  85.  
  86.      _TTTT_SSSS_YYYY_SSSS_EEEE_RRRR_RRRR           A system error has occurred during execution of this
  87.                        function.
  88.  
  89. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  90.      _iiii_nnnn_tttt_rrrr_oooo(3N), _tttt______rrrr_cccc_vvvv_uuuu_dddd_aaaa_tttt_aaaa(3N), _tttt______ssss_nnnn_dddd_uuuu_dddd_aaaa_tttt_aaaa(3N)
  91.  
  92. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  93.      _tttt______rrrr_cccc_vvvv_uuuu_dddd_eeee_rrrr_rrrr returns 0 on successful completion and -1 on failure and
  94.      _tttt______eeee_rrrr_rrrr_nnnn_oooo is set to indicate the error.
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.